用途:ws-update 用于把当前来源(项目、对话、研究过程)中值得长期保留的知识提炼并写入用户的 wiki;在没有 wiki 时也可先行初始化。
wiki 模型:wiki 是一个文件夹,其 index.md 含 ## Spaces 标题,作为导航契约,其中列出每个 space(形如 - label — description)。space 可递归嵌套;无 index.md 的普通文件夹只用于分组。Markdown 方言为 Obsidian。
解析与模式:解析顺序为显式路径 → 最近的 CWD 祖先 wiki → 配置中的 wiki。模式依用户意图分为直接添加、项目同步、对话捕获、研究捕获;CWD 仅用于判断项目,不决定模式。
主要能力:随附只读脚本 scripts/ws.py(Python 3.9+ 标准库),提供 list、files、grep、check-size、audit 等子命令,分别用于列出 space、列出可及 markdown、正则检索、写入前校验体量、审计契约漂移。脚本只解析结构,含义判断由使用者完成。
使用方式:写入前用 check-size --stdin 校验;新建页面沿用最近的 _template.md,合并时保留手工内容并更新 updated;创建或移动 space 后需同步更新 ## Spaces。属性为 external 的范围默认只读,写入仅限目标 space。
限制:体量上限按 UTF-8 字节计(index.md 5000, log.md 与 hot.md 100000, 其他 15000),可在 _meta/limits.md 自定义;超限时应提炼或重构而非截断或提高上限;log.md 超限时整体归档。脚本只读,不自行写入;audit 中不安全的发现仅上报,需用户决定。配置路径失效属硬停止,不触发初始化。关于是否收费、价格与平台支持,资料暂未提供。