关于 Comondex
以模块为单位:点进一个模块,查看它的开发成员与开发方式。
FlowDesk
开发成员与开发方式。
项目
每个项目都有能跑起来的产品,而不是教程 Demo。
FlowDesk
AI 驱动的个人与小团队工作管理平台——桌面客户端 + 云端服务端,联网协作、数据自控。
FlowDesk 是 Comondex 的核心桌面应用:把散落在表格、聊天和网盘里的项目、任务、文件与讨论,收拢到一条完整闭环——建立空间 → 创建项目 → 拆解任务 → 成员执行 → 评论/文件协作 → 仪表盘汇总 → AI 理解项目状态。
产品以桌面客户端(Electron)+云端服务端双形态交付:本机一键运行即为单机版;部署服务端后,同局域网设备通过 UDP 自动发现即可联网协作,服务端不在线时自动降级本地模式,数据始终由自己掌控(SQLite / 自部署服务端)。跨网络场景还可通过 Tailscale 组网获得永久固定地址。
工程上,FlowDesk 已完整走完 M1–M9 九个里程碑:项目 CRUD、账户体系(scrypt 密码哈希 + 登录限流)、空间与成员权限矩阵、任务全生命周期(If-Match 乐观锁)、文件管理、仪表盘聚合、评论与活动留痕,以及原生内置的 AI Copilot——基于 OpenAI 兼容 API,能理解项目状态并生成任务提案,且所有提案经确认后才落库。
每一次改动都要通过 43 个后端测试才能合并,这让 FlowDesk 不只是“能用”,而是可维护、可信赖。
def throttle():
# 每 60 秒窗口内最多 30 次密码校验,防止暴力破解
now = time.monotonic()
while requests and now - requests[0] > 60:
requests.popleft()
if len(requests) >= 30:
raise HTTPException(429, '操作太频繁,请一分钟后再试',
headers={'Retry-After': '60'})
requests.append(now)
def current_user(request: Request):
raw = request.cookies.get(cookie_name)
if not raw or len(raw) > 128:
raise HTTPException(401, '请先登录 FlowDesk')
with Session(engine) as db:
session = db.get(LoginSession, token_digest(raw))
if not session or aware(session.expires_at) <= utcnow():
raise HTTPException(401, '登录已过期,请重新登录')
user = db.get(User, session.user_id)
if not user:
raise HTTPException(401, '请重新登录')
return user
def call_llm(settings, messages, system_prompt, json_mode=False) -> str:
"""调用 OpenAI 兼容 /chat/completions,返回回答文本。"""
base_url = (settings.base_url or DEFAULT_BASE_URL).rstrip('/')
payload = {
'model': settings.model or DEFAULT_MODEL,
'messages': [{'role': 'system', 'content': system_prompt}]
+ [{'role': m['role'], 'content': m['content']}
for m in messages],
'temperature': 0.3,
}
if json_mode:
payload['response_format'] = {'type': 'json_object'}
with httpx.Client(timeout=60) as client:
response = client.post(
f'{base_url}/chat/completions',
headers={'Authorization': f'Bearer {settings.api_key}'},
json=payload,
)
response.raise_for_status()
data = response.json()
return data['choices'][0]['message']['content']
@router.patch('/tasks/{task_id}', response_model=TaskOutput)
def update_task(task_id: int, body: TaskPatch, request: Request,
user: User = Depends(current_user)):
with Session(engine) as db:
task, project, _role = task_access(db, task_id, user.id)
# 乐观锁:If-Match 携带 version,不匹配即冲突
expected = request.headers.get('if-match')
if expected and expected != str(task.version):
raise HTTPException(409, '任务已在其他页面修改,请刷新后重试')
changes = body.model_dump(exclude_unset=True)
if 'assignee_id' in changes:
validate_assignee(db, project, changes['assignee_id'])
for key, value in changes.items():
setattr(task, key, value)
touch_completed_at(task)
task.updated_at = datetime.now(timezone.utc)
try:
db.commit()
except StaleDataError:
raise HTTPException(409, '任务已被修改,请刷新后重试')
db.refresh(task)
return task
<script setup>
const settingsDialog = ref(null)
// 修复:设置按钮此前只切换 v-if、未真正打开 dialog
// 现在通过原生 <dialog>.showModal() 打开模态框
function openSettings() {
settingsDialog.value?.showModal()
}
</script>
更新日志
- 登录 / 注册输入框的 placeholder 黑字全部移除,保持界面干净;「在此浏览器保持登录」改为「保持登录」。
- 活动页顶部新增「← 返回空间」按钮,补齐离开路径。
- 仪表盘 SVG 小字由 8px 提升至 9px / 18px,浅灰 #999 / #aaa 加深为 #6b7280 色系,字符清晰度修复。
- 仪表盘 / 表格板块接入全局设计语言:卡片 + 阴影 + 主色 #5c56db,统一三板块 UI。
- 修复 AI 助手「设置」无响应 bug——设置 dialog 此前只以 v-if 挂载、未真正调用 showModal(),已修复。
当前状态
v0.1.1,已完成 M1–M9
技术栈
功能要点
- M1–M9 九大模块全部完成
- AI Copilot 原生内置
- 局域网 UDP 自动发现联网
- If-Match 乐观锁防冲突
- 43 个后端测试守护
对 FlowDesk 感兴趣?
想了解进展、参与开发或提需求,欢迎加入项目组一起讨论。
Pushor
截图打卡提交与人工审核系统——成员上传凭证,管理员在终端风格后台逐条审核。
Pushor 是 Comondex 的协作实践项目:成员在自学、复习、运动等活动结束后上传打卡截图;管理员在一个终端风格的 Web 后台里查看待审截图,给出通过或驳回(必须写原因)。系统只做截图的提交与人工审核——不计算金额、不记账、不做日结、没有余额、不能转账、不接任何支付。
工程上,Pushor 是 Next.js 14 App Router 的纯静态导出:构建产物只有 HTML/JS/CSS,托管在 Cloudflare Pages,不需要任何 Node 服务器。所有 Supabase 交互(登录、查询、上传、审核)都在浏览器端完成,安全边界完全落在数据库层——每条 SQL 都带着当前登录用户的会话,Postgres 的 RLS 策略决定他能看到和改动什么。
截图存放在私有 bucket 中,页面渲染时换成 10 分钟有效的签名 URL;驳回后重新提交通过 replaces_id 形成可追溯链条。仓库内置 30 条 RLS / 流程验收用例,直接打 Supabase API,全部通过才允许合并。
create policy "submissions_member_insert_pending" on submissions
for insert to authenticated
with check (
member_id = auth.uid() and status = 'pending'
and admin_note is null and reviewed_at is null
and (storage.foldername(image_url))[1] = auth.uid()::text
and exists (select 1 from tasks t where t.id = submissions.task_id and t.member_id = auth.uid())
and (replaces_id is null or exists (
select 1 from submissions s where s.id = submissions.replaces_id
and s.member_id = auth.uid() and s.status = 'rejected')));
create policy "submissions_admin_review" on submissions
for update to authenticated
using (is_admin() and status = 'pending')
with check (
is_admin() and status in ('approved','rejected')
and (status <> 'rejected' or coalesce(btrim(admin_note),'') <> ''));
const { createClient } = await import("https://esm.sh/@supabase/supabase-js@2");
const sb = createClient("<URL>", "<ANON KEY>");
const res = await sb.from("submissions")
.update({ status: "approved" })
.eq("id", "<你自己的 submission id>")
.select();
console.log(res); // data: [] —— 命中 0 行,数据库里那条仍是 pending
当前状态
已上线,运行于 pushor.pages.dev
技术栈
功能要点
- 成员提交打卡截图,一次最多 10 个附件
- 管理员待审队列 + 逐条人工审核
- 驳回必须写原因,重提交经 replaces_id 可追溯
- Postgres RLS 为唯一安全边界
- 30 条 RLS / 流程验收用例守护