
https://codeberg.org/lomi/GardenMansion
这几乎可以是我所有 repos 用的语言最多的了?并且每个都合情合理……
最初企划大抵是去年十月份,上个月完工. 大概在某一天,想做个项目,一个我也不知道该怎样的项目,就突然想做个有趣的项目. 瞧,PureScript 是 Haskell in JaavScript,似乎可以用它做个前端应用,社区也有 React FFI.
但……还有个 Elm (Haskell-like)是专门做前端?吾……好,那就全栈应用吧?好,现在我们需要公共数据类型定义,应该使用 PureScript 还是 Elm 了?总感觉偏袒谁都不合适……?
那……Haskell 本尊你过来下!就用你来做个中间层表示了. 看起来需要转换,使用 AST 的话这涉及三门语言的 codegen,且都是小众语言,可谓难上加难而且很重. 既然这三个语言都是 Haskell 系,语法如此相像……直接字符串处理好了!那么用谁了?TypeScript?不不太不够味道了,Elm 做不了,PureScript 和 Haskell 需要编译再执行……而且这脚本操作对于 Haskell 也不合适. 诶?Python 虽然其类型注解招笑而无法碰瓷伟大的 TypeScript 对吧?但加上类型注解写法的美化版 Python 有股 ML 系语言的味喔,又是缩进又是“->”、match、“F[T]”……就你了.
好了,我需要考虑下我们伟大的 PureScript 用什么后端框架. 啊,spago 怎么无法安装这个?怎么又报错了?这库怎么这么老?都很喜欢重复造轮搞抽象是吧?事已至此,与其学习别人那些无所谓的抽象高成本,不如我自己抽象一套还能学点东西,同时让人看起来很简洁对吧?那么 FFI 启动!JavaScript 你也过来下帮点小忙!JavaScript 侧什么框架了?那还用说,都说了简洁和学习意义了,自然数 node-http 简易封装 FFI 之后 PureScript 抽象!
嘶……Elm、Haskell、PureScript 三个 Haskell-like 语言都聚过来了?这……(看向 Idris)你也过来吧!做点什么了?就你了——PureScript 负责 http 相关核心部分,Idris 负责 leveldb 封装!思路是 Idris 接 JavaScript FFI 封装,接着编译到 JavaScript,PureScript 再对接 Idris 的 JavaScript. 好吧,我承认这很强行了,但比较有趣. 至于应用配置自然是使用高贵的 Dhall —— 配置编程语言. 语法也很 Haskell-like 就是了.
前端需要 CSS 怎么办了?似乎 Elm 有自己的一套,但成本学习……而且不完全好使. UuoCSS——我最爱用的原子化 CSS 你也过来下吧!Devseever了?那还是 vite 吧?需要配置和 bootstrap?那 TypeScript ……你也回来干点小事吧(bootstrap.ts 里动态(考虑到不同环境)导入 Elm 的构建结果和处理 Elm 的 vite 插件). 然后了 Web 项目自然还需要写一些基本的 Html、CSS 文件就是了哈哈.
既然我们用到了这么多,似乎需要做项目构建启动脚步的操作,该怎么办了?仅 package.json npm?掉价了!那……makefile?这是要回归野蛮吗?就你了——Just,又现代又小巧又通用……(然后 justfile 管理设计和协调整个项目的构建与开发弄了半晚上,相当有趣说是)
代码托管的选择固然也得有点个性,GitHub 的恶毒无需多言,巨硬的手中既无自由更无开源可言. 毫无缘由地封禁 Repos,工单过去了五个月仍未回复,罪恶罄竹难书. 最佳答案就是 Codeberg 了。
最后我们到底写了个什么了?其实就是一个简简单单,用 TypeScript 很快就能写完的 crud 应用. 大致是一个合租管理(收费记录、留言)系统?这源于去年十月份看的某个小说中得到的灵感.
其实过程中我还想过 Ferge 语言,是 JVM 生态里的 Haskell. 但看起来 JVM 我不是很感兴趣且太远了关系不大,加上玩意基本死了,所以不了了之. ReScript 也打算过, 可是有了它,那 Ocaml 和 F# 也……不行不行,这里是 Haskell-like 坐一桌!或许以后考虑再开一个 Ocmal-like 项目和 FP 大家族(更多地包括新兴的 FP 语言)……?
对于这项目,还想到再来点 Haskell 代码(因为本尊的代码量似乎很少),弄一个启动器或者数据库查询的 CLI 应用,不过那会已经是几个月前,接近尾声了,何况 Haskell 本身在 Windows 上开发也是有点痛苦,自然是不了了之. 值得一提的是,几个月前见识到了 Bun 的好,几乎在写的用了 Node.js 的项目都是能迁移到 Bun 就迁移了,本项目也不例外. 比较损的是,虽迁移,但仍旧使用的 node-http 作为后端底层,一来我不想再改,二来兼容性不赖.
最后是后话,上周在捣鼓效果编程语言,先是 Koka 后是 Unison、Flix,其中 Unison 我发现也很 Haskell-like(可说是加上效果系统的 Haskell),没加进来着实可惜,不过又想到 Unison 的独特开发方式估计也难以融入(笑).
毫无疑问,这从未打算做成正经的项目给人用,它的功能本身就是 Demo 级的(实用性为零),但又绝对不同于任何低劣的 Demo. 想到如果它用正常的 TypeScript 写的话,很快就能做完甚至做得更强,但显然这业务本身是毫无趣点吸引我,而且简单至极(愚蠢而无意义的 Demo 究竟谁会写了?无异于无趣的新人写无趣的图书管理、电商管理系统云云),故前提不成立. 既然如此,我觉得有没有人用更无所谓了,毕竟最大乐趣已经漂移到过程本身了.
之于 AI 编程的时代. 直播时隔三岔五有人见我没有打开 Agent 于是便发出“这是古法编程吗”的疑问. 对待提问应当澄清概念在先,必要思考:什么算古法编程?什么不算古法编程?如果说不用需要订阅或者购买 Api 的名义上“Agent”工具就算古法编程,那我自然是的,因为星期四都无人 V 我 50,何来钱购买高昂的 DeepSeek、Claude、Codex 了?如果说完全一个一个字写,不用任何 AI 技术算古法编程,那我显然不是. 只要白嫖到最后,我想哪怕不赚也不会亏,所以白嫖使用网页客户端 AI 就不错了(笑). 再者 AI 的愚蠢乃有目共睹(或许我过后会抽空写篇文章怒批 AI 写出的愚蠢代码),高度代码洁癖是无法容忍 AI 写一坨命令式逻辑、啰嗦冗余的垃圾、文件连续空行超过一行、四空格缩进、无意义变量声明、愚蠢的代码组织形式、愚蠢的理解能力、愚蠢的项目组织结构、奇葩的命名、奇葩的类型定义、傻逼一样的注释…… Prompt 的文字是难以向 AI 说尽要求的,因为我自己也难以总结出其具体审美规范,所以完全交由 AI 不现实,代码总是会由我亲自审查几遍的. 反过来,根本没怎么学过编程的人,自然毫不在意所谓的代码质量、风格审美、可维护性、健壮性,也就成了 AI 编程的坚定拥护者、吹嘘者.
说到这里,就必须提起花了几天时间做的 Web Agent 项目,简而言之基于 MarkDown DSL 表示读写改等操作,通过 apply 可直接应用网页 AI 返回的合法消息或者自动监听剪贴板,也可以一键打包指定上下文的文件内容给网页 AI,优点在于人类开发者依旧有主导权和控制权,同时解决了朴素的复制粘贴网页 AI 内容的麻烦,相当于小型的 Agent,但又依附于任何网页 AI,根本不需要花一分钱也能很高效
总而言之,写这项目的过程是异常有趣的,高度的精确至空行数量与结尾空行的代码洁癖姑且算是一股清流了. 不过又如开头所说,这绝不是一个面向工业的正经项目,那到底算是什么了?或许是一回有趣的过程体验,一个别样的行为艺术,一次独特的个人表达,一场无聊的炫技表演……都可以是,任你解读.
对于过程,多少还是了能学到不少东西(重要程度降序):
多种语言操作、FFI 对接
多语言构建流程搭建、调度、设计
Monad Transform 的实际应用
Async Monad 的封装
函数式的后端基本框架的封装
前端页面的响应式编程开发
超复杂 CICD 的搭建
完整的前后端分离项目的 CRUD 流程
Vite、Just、Bun 的基本使用

项目构建流:
set windows-shell := ["powershell.exe"]
dir := justfile_directory()
server := dir + "/server"
client := dir + "/client"
db := dir + "/db"
# List all available tasks
default:
@just --list
# Start vite server
dev-f:
@echo "🚀 Starting vite server..."
cd {{client}}; bun vite
# Start backend server
dev-b:
@echo "🚀 Starting backend server..."
cd {{server}}; bun ../scripts/watch-backend
# Build
build:
just build-f; just build-d; just build-b; cd server; bun build bin --minify --target node --outfile=server.js; cp ../client/dist static -r
# Build frontend
build-f:
@echo "🏗️ Building frontend..."
cd {{client}}; bun vite build
# Build backend
build-b:
@echo "🏗️ Building backend..."
cd {{server}}; spago build
# Build database
build-d:
@echo "🏗️ Building database..."
cd {{db}}; idris2 --cg node --build
# Clean build files
clean:
@echo "🧹 Cleaning build files..."
rm -rf {{client}}/dist
rm -rf {{client}}/elm-stuff
rm -rf {{server}}/output
rm -rf {{server}}/.spago
# Run tests
test:
@echo "🧪 Testing backend..."
cd {{server}}; spago test
# Renerate types
gen:
@echo "🤖 Generating types..."
python scripts/generate.py
后端的核心抽象:
type Romi env = ExceptT Response (ReaderT env Aff)
type Guard env a = Request -> Romi env a
type Handler env = Guard env Response
response :: forall env a (m :: Type -> Type) e .
Responseable e =>
MonadError e m =>
MonadReader env m =>
e -> m a
response = throwError
data Route env = Route Method String (Handler env)
type Routes env = Array (Route env)
Idris 的数据库封装:
public export
delOrIf : DB -> (key : String) -> (test : String -> Bool) -> AsyncIO ()
delOrIf db key test = do
result <- get db key
case result of
Just v => if test v then del db key else pure ()
Nothing => pure ()
public export
data BatchOp : Type where
Put : (key : String) -> (value : String) -> BatchOp
Del : (key : String) -> BatchOp
-- ...
public export
batch : DB -> List BatchOp -> AsyncIO ()
batch _ [] = pure ()
batch db ops = primBatch db $ build ops
where
trans : BatchOp -> PrimBatchOp
trans (Put k v) = primPutBatchOp k v
trans (Del k) = primDelBatchOp k
build : List BatchOp -> PrimBatchOps
build [] = primCreateBatchOps $ primDelBatchOp ""
build [a] = primCreateBatchOps $ trans a
build (op :: ops) = primAddBatchOp (build ops) $ trans op
public export
data ArrayOps = PrivatelyMkArrayOps
public export
%foreign """
node:lambda:(db, ops) => async () => await db.batch(ops)
"""
batchExternal : DB -> ArrayOps -> AsyncIO ()
public export
%foreign """
node:lambda:(db) => async () => await db.close()
"""
close : DB -> AsyncIO ()
PureScript 的数据库对接
class ProvideDB env where
getDB :: forall m. MonadReader env m => env -> m DB
type DBOps m k =
{ get :: k -> m (Maybe String)
, put :: forall c . WriteForeign c => k -> c -> m Unit
, putOr :: forall c . WriteForeign c => k -> c -> m Unit
, putOrIf :: forall c . WriteForeign c => k -> c -> (String -> Boolean) -> m Unit
, del :: k -> m Unit
, delOrIf :: k -> (String -> Boolean) -> m Unit
, batch :: Array (BatchOpModel k) -> m Unit
}
dbOpsOf :: forall env keys m .
MonadReader env m =>
MonadAff m =>
ProvideDB env =>
Show keys =>
DBOps m keys
dbOpsOf =
{ get: \k -> do
db <- ask >>= getDB
liftAff $ dbGet db $ show k
, put: \k v -> do
db <- ask >>= getDB
liftAff $ dbPut db (show k) $ writeJSON v
, putOr: \k v -> do
db <- ask >>= getDB
liftAff $ dbPutOr db (show k) $ writeJSON v
, putOrIf: \k v cond -> do
db <- ask >>= getDB
liftAff $ dbPutOrIf db (show k) (writeJSON v) cond
, del: \k -> do
db <- ask >>= getDB
liftAff $ dbDel db $ show k
, delOrIf: \k cond -> do
db <- ask >>= getDB
liftAff $ dbDelOrIf db (show k) cond
, batch: \ops -> do
db <- ask >>= getDB
liftAff $ dbBatch db $ map (\x -> case x of
PutM k v -> Put (show k) v
DelM k -> Del (show k)
) ops
}
type ListModel m b =
{ selectAll :: m (Array b)
, select :: (b -> Boolean) -> m (Maybe b)
, selectMany :: (b -> Boolean) -> m (Array b)
, update :: (b -> Boolean) -> (b -> b) -> m Unit
, insert :: b -> m Unit
, insertMany :: Array b -> m Unit
, deleteAll :: (b -> Boolean) -> m Unit
, rowId :: m Int
}
type ListModelApi keys dat =
{ key :: keys
, parse :: String -> Either String (Array dat)
, rowId :: dat -> Int
}
makeModel :: forall keys dat env m.
MonadReader env m =>
MonadAff m =>
Show keys =>
WriteForeign dat =>
ProvideDB env =>
ListModelApi keys dat -> ListModel m dat
makeModel {- ... -}
PureScript 的应用层定义:
routers :: Routes Env
routers =
[ Route GET "/api/messages" fetchAllMessages
, Route POST "/api/messages" createMessage
, Route DELETE "/api/messages" deleteMessage
, Route GET "/api/expenses" fetchAllExpenses
, Route POST "/api/expenses" createExpense
, Route DELETE "/api/expenses" deleteExpense
, Route GET "/api/users" fetchAllUsers
, Route POST "/api/users" createUser
, Route DELETE "/api/users" deleteUser
, Route GET "/api/meta" fetchMeta
, Route PUT "/api/meta" updateMeta
, Route GET "/api/info" fetchInfo
, Route PUT "/api/info/rename" renameInfo
, Route PUT "/api/info/password" changePasswordInfo
, Route POST "/api/login" loginIn
]
envInit :: ApplicationConfig -> Aff Env
envInit config = do
db <- dbCreate (pathJoin currentDir config.dataDir) dbPrefix
let env = Env { db, logger, user: Nothing }
_ <- runReaderT (runExceptT (do
dbOps.putOrIf Users defaultModelUsers $ isLeft <<< parseModelUsers
dbOps.putOrIf Messages "[]" $ isLeft <<< parseModelMessages
dbOps.putOrIf Expenses "[]" $ isLeft <<< parseModelExpenses
dbOps.putOrIf Meta { webUrl: "http://localhost:" <> show config.port
, webName: config.defaultName
, webTitle: config.defaultTitle
, webNotice: config.defaultNotice
, webStartTime: config.defaultStartTime
} $ isLeft <<< parseModelMeta
pure unit
)) env
pure env
where
logger :: Logger Aff
logger = {- ... -}
前端入口:
import 'uno.css'import './assets/style.css'import { Elm } from './Main.elm'
if (process.env.NODE_ENV === 'development') {
const ElmDebugTransform = await import('elm-debug-transformer')
ElmDebugTransform.register({ simple_mode: true })
}
const root = document.querySelector('#app')
if (root === null) {
throw new Error('Root element not found')
}
const app = Elm.Main.init({
node: root,
flags: localStorage.getItem('himeno_token') || null
})
app.ports.saveToken.subscribe((token: string | null) => {
if (token === null) {
localStorage.removeItem('himeno_token')
} else {
localStorage.setItem('himeno_token', token)
}
})
Haskell 的数据定义:
data ResMetaApi = ResMetaApi
{ res_webUrl :: String,
res_webName :: String,
res_webTitle :: String,
res_webNotice :: String,
res_webStartTime :: Double
}
type ModelMeta = ResMetaApi
data ReqUserApi = ReqUserApi
{ req_userName :: String,
req_userNickname :: String,
req_userPassword :: String
}
data ResUserSingle = ResUserSingle
{ res_userId :: Int,
res_userName :: String,
res_userNickname :: String,
res_userTime :: Double,
res_userLevel :: Int
}
{- ... -} Elm 的入口:
main : Program (Maybe String) Model Msgmain =
Browser.element
{ init = init
, view = view
, update = update
, subscriptions = \_ -> Sub.none
}
Python 的类型生成入口:
def main() -> None:
script_dir = Path(__file__).parent
root_dir = script_dir.parent
source_file = root_dir / "models" / "Models.hs"
elm_target = root_dir / "client" / "src" / "Models.elm"
purs_target = root_dir / "server" / "src" / "Models.purs"
if not source_file.exists():
raise FileNotFoundError(f"🤣 Source file not found: {source_file}")
generate_file(source_file, elm_target, transform_to_elm)
generate_file(source_file, purs_target, transform_to_purescript)
print("\n🎉 Done.")
if __name__ == "__main__":
main()
什么都可以少,但 Git Commits 规范得遵守,否则就是无礼的小孩在过家家般写代码;CICD 更是得有,否则就是居住在工业革命前的现代野人:
name: Build & Upload Artifacts
on:push:
branches: [main]
paths-ignore:
- "**.md"
- "LICENSE"
- ".gitignore"pull_request:
branches: [main]
jobs:build:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup Just
uses: extractions/setup-just@v4
with:
just-version: "1.40"
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: latest
- name: Setup PureScript
uses: purescript-contrib/setup-purescript@main
with:
purescript: "latest"
spago: "latest"
- name: Install elm
run: |
bun add -g elm@0.19.1
elm --version
- name: Install Idris2 & dependencies
run: |
sudo apt-get update
sudo apt-get install -y chezscheme
echo "chezscheme" | bash -c "$(curl -fsSL https://raw.githubusercontent.com/stefan-hoeck/idris2-pack/main/install.bash)"
echo "$HOME/.pack/bin" >> $GITHUB_PATH
- name: Install Python dependencies
run: python -m pip install --upgrade pip
- name: Install npm dependencies
run: |
bun install
cd client && bun install
- name: Run just build
run: |
just gen
just build
just test
- name: Upload Frontend Build
uses: actions/upload-artifact@v4
with:
name: frontend-dist
path: client/dist/
retention-days: 30
if-no-files-found: warn
- name: Upload Backend Build
uses: actions/upload-artifact@v4
with:
name: backend-bundle
path: server/server.js
retention-days: 30
if-no-files-found: warn
- name: Upload Database Build
uses: actions/upload-artifact@v4
with:
name: db-build
path: db
retention-days: 30
if-no-files-found: warn
- name: Upload Unified Artifacts (Combined)
uses: actions/upload-artifact@v4
with:
name: garden-mansion
path: |
server/server.js
server/static/
server/sena.dhall
retention-days: 30
if-no-files-found: warn #函数式##函数式编程##TypeScript##全栈##前端##后端##Idris##Haskell##PureScript##Web##Elm##Python##CRUD##Java##编程##项目##开源#