JianFeeeee
0e754617a4
Go 单二进制网关 + React 前端 + opencode 桥接插件。部署产物是 「一个二进制加一个 .db 文件」：前端经 go:embed 打进二进制， 数据库默认内置 SQLite，systemd 托管。 核心设计 - 三维寻址 name@path.session，按最后一个 . 切分；session 位三态： 省略=默认会话 / new=强制新建 / 具体别名=必须已存在（否则 404 无法送达） - 会话别名默认复用 Agent 平台自己的命名机制（opencode 的 slug 与模型生成的 标题），不在本侧另造一套；人显式定过的别名不被平台同步覆盖 - 对话树不建 tree_nodes 表：parent_mail_id 已完整编码树结构， 再维护一张表就是第二份真相。用递归 CTE 查，按方向分块加载 - 附件内容存磁盘、按 sha256 内容寻址，数据库只存元数据；天然去重， 且路径与用户 filename 无关，杜绝 ../ 穿越 - 配额约束的是模型的自主发信，不是 harness 的转发：插件代劳的权限询问与 最终总结走免配额通道，靠上游消息 id 做幂等键而非计数 - 往返预算下沉到会话（写信时给、对话页里改）+ Agent 全局配额，两层都要过 后端 gateway/ - models/repo/handler/middleware/sse/blob 分层；两方言（SQLite/PostgreSQL） 共用一份 repo 层 SQL，差异集中在 internal/db - 多用户认证（bcrypt cost12、登录限速、会话隔离、权限边界） - 密钥体系：Agent 密钥与用户密钥分表，三种生命周期；登记式密钥让全文 只从客户端流向服务器一次 - 所有「判断 + 自增」都在同一条 UPDATE 里（配额、预算、one_time 密钥、 附件挂载），并发下不会刷穿 前端 web/ - 三栏布局、三段式地址补全、权限卡片、密钥面板、配额面板、对话树、附件 - 全站纯 SVG 图标，不使用 emoji - api/ 即可复用的客户端 SDK：基地址与凭证集中在 api/config.ts 插件 plugins/opencode-mail-bridge/ - 六个工具 + 两类自动转发（permission.ask 钩子接管平台原生权限询问、 session.idle 时转发本轮总结）
70 lines
2.0 KiB
Go
70 lines
2.0 KiB
Go
package handler
|
||
|
||
import "testing"
|
||
|
||
// 平台侧 slug/标题不受本侧寻址约束，normalizeAlias 必须把它改写成
|
||
// 能安全出现在 name@path.<alias> 末段的形式。
|
||
func TestNormalizeAlias(t *testing.T) {
|
||
cases := []struct{ in, want string }{
|
||
// opencode 风格 slug 原样通过
|
||
{"jolly-cactus", "jolly-cactus"},
|
||
{"fix-memory-leak", "fix-memory-leak"},
|
||
|
||
// 非法字符统一换 -，连续的压缩成一个
|
||
{"fix.memory.leak", "fix-memory-leak"},
|
||
{"修复 登录态 丢失", "修复-登录态-丢失"},
|
||
{"a//b..c", "a-b-c"},
|
||
{"user@host", "user-host"},
|
||
|
||
// 首尾的分隔符要去掉
|
||
{".leading", "leading"},
|
||
{"trailing.", "trailing"},
|
||
{" spaced ", "spaced"},
|
||
|
||
// 保留字必须避开，否则会被寻址当成「新建会话」
|
||
{"new", "session-new"},
|
||
|
||
// 全是非法字符 → 空串，交由调用方报错
|
||
{"...", ""},
|
||
{"", ""},
|
||
}
|
||
|
||
for _, c := range cases {
|
||
if got := normalizeAlias(c.in); got != c.want {
|
||
t.Errorf("normalizeAlias(%q) = %q, want %q", c.in, got, c.want)
|
||
}
|
||
}
|
||
}
|
||
|
||
// 规范化后的别名必须能通过寻址校验，否则同步会写进一个自己都拒绝的别名。
|
||
func TestNormalizeAliasPassesValidation(t *testing.T) {
|
||
for _, in := range []string{
|
||
"jolly-cactus", "fix.memory.leak", "修复 登录态 丢失", "new", "user@host/path",
|
||
} {
|
||
norm := normalizeAlias(in)
|
||
if norm == "" {
|
||
continue
|
||
}
|
||
if err := validateSessionAlias(norm); err != nil {
|
||
t.Errorf("normalizeAlias(%q) = %q，但未通过 validateSessionAlias: %v", in, norm, err)
|
||
}
|
||
}
|
||
}
|
||
|
||
// 截断长别名时不能切坏多字节字符（session_alias 是 VARCHAR(128)）。
|
||
func TestNormalizeAliasTruncatesOnValidUTF8(t *testing.T) {
|
||
long := ""
|
||
for i := 0; i < 100; i++ {
|
||
long += "修" // 每个 3 字节，共 300 字节
|
||
}
|
||
got := normalizeAlias(long)
|
||
if len(got) > 128 {
|
||
t.Errorf("normalizeAlias 截断后 %d 字节，超过 128", len(got))
|
||
}
|
||
for _, r := range got {
|
||
if r == '\uFFFD' {
|
||
t.Fatalf("normalizeAlias 截断产生了非法 UTF-8: %q", got)
|
||
}
|
||
}
|
||
}
|