前言¶
在 DeepSeek Harness（DSH）里做长程重构或跨模块改动时，常见做法是往同一条 Agent 对话里堆更多上下文：压缩、检索、记忆。Thaliris 的出发点不同：它认为更大的损耗往往来自同一条推理轨迹里目标过多——调查、实现、调试、自审和「之前的失败」挤在一起，强模型的注意力被噪声稀释；子代理交回「局部完成」后，审查阶段的反证也可能在几轮修复里被测试通过悄悄盖掉。
Thaliris-dsh（npm 包名 @thaliris/dsh-plugin）是维护者 Iris0fTheValley 提供的 DSH 工作流类插件：不另造 Agent Runtime，而是把 Thaliris 的任务记录、Controller 工具接到 DSH 原生的 Workspace、持久 Session、Agent/subagent、Settings 与共享 Web/Desktop 客户端扩展上，并通过 Python bridge 调用单独安装的 Thaliris Core。下面介绍它解决什么问题、能做什么，以及如何按官方文档安装与启用。
这是什么¶
Thaliris 整体定位是面向 AI 编程 Agent 的认知编排层（项目状态：Beta）。Thaliris-dsh 只负责 DeepSeek Harness 这一侧的 Adapter：集成 Workspace/Session/Agent、可选 Memory，以及策略页里的角色与模型路由；Core 的 task ID、observation、证据与 freshness 等能力由共享的 Thaliris Core 提供，本仓库不复制 Core 或 Codex adapter。
社区目录页：https://www.skillhub.cn/plugins/Iris0fTheValley/Thaliris-dsh（独立站点，与 DeepSeek / 幻方无官方从属关系）。源码与说明：https://github.com/Iris0fTheValley/Thaliris-dsh。当前插件版本见 package.json：0.2.0，许可证 MIT。
核心能力（与 DSH 相关的部分）¶
认知隔离与角色¶
长期 Controller 持有用户目标、硬约束和验收标准；Investigator、Implementer、Focused Implementer、Reviewer 等短期角色在全新上下文里做局部工作，不继承父级对话，只交回结论、来源、验证结果和会改变决策的未知项。角色按需选用，不是固定流水线；不同角色可配不同模型，路由模式在 DSH 策略里为 inherit、fixed 或 allowed。初始角色模板采用 inherit 且不固定模型；模板变更不会覆盖已保存的用户角色记录。
Evidence Continuity¶
子角色发现、且会改变结论或验收的反证会登记为 observation；在 Controller 明确处置（已满足 / 未知 / 需修复 / 已不再相关）之前，相关证据会在后续交接中持续出现；测试 PASS、子代理 Completed 等不能自动让「需修复」退场。Adapter 把子代理结果交给 Controller 时会重新呈现仍未处置的关键证据。任务状态保存在仓库内的结构化文件中，不保存对话 transcript；持久化与「塞给每个角色」是两件独立的事。
DSH 策略页与 Workspace¶
DSH 的策略页可配置角色提示词、模型路由、工具、Workspace 和 Memory。Workspace 精确绑定和持久 root Session是任务关联的一部分：单凭仓库路径不会恢复旧任务。启用前需在 DSH 注册规范 Git root 为 native Workspace，创建或恢复持久 root Session，并在策略中绑定准确的 Workspace ID 与 root。
Memory（可选）¶
Memory 默认关闭，可单独安装 memory capability 与本地文本 provider；task routing 与 close 无需启用 Memory 或 client UI。文档明确：没有 embeddings/vector RAG 或自动检索；读取受授权控制，写入遵循用户许可与 Core task 检查。边界见仓库内 CAPABILITIES.md、CLIENT-CONTRACT.md。
Thaliris 不是什么¶
不是 Agent runtime、工作流引擎、固定多代理流水线、向量库或 RAG、全仓自动总结器；也不能替代源码、测试与编译器。删除 Thaliris 后，底层开发流程仍应能独立成立。
安装与启用¶
环境¶
- 构建插件：Node.js 22.19+ 或 24+（见
package.json的engines）。 - 运行 Thaliris Core：Python 3.11+。
- 需从与当前 DSH/Core 配对的版本构建本地 archive，配对说明见仓库 CORE-BASELINE.md。
安装 Thaliris Core（多代理与任务记录依赖）¶
在目标仓库根目录初始化 Core（与是否安装 DSH 插件无关，但插件通过 bridge 调用 Core）：
uv tool install git+https://github.com/Iris0fTheValley/Thaliris
cd your-repository
thaliris-core --root . init
TASK_ID=$(thaliris-core --root . task-start "example task" | python -c 'import json,sys; print(json.load(sys.stdin)["task_id"])')
thaliris-core --root . --task-id "$TASK_ID" task-status
每个任务有独立 Task ID，后续 CLI 操作需显式传入 --task-id。只安装 Core 不会启用 DSH 侧多代理编排，需再按 Thaliris-dsh 指南安装插件。
初始化后典型目录（摘自官方说明）：
.agent-memory/ # 经选择、可跨任务复用的项目知识（可纳入版本控制）
.milestones/ # 长期进度：scope / decisions / progress / verification
.context/tasks/<task-id>/state.json # 单个任务的状态与证据（默认被 Git 忽略）
构建并安装 DSH 插件¶
在 Thaliris-dsh 源码目录构建 bundle 与客户端，再打包：
npm run build:bundle
DSH_SOURCE="/path/to/pinned-dsh-checkout" npm run build:client
npm pack
通过 DSH Plugin Manager 安装主插件 archive。仅在使用 Memory 时一并安装两个可选 archive：
PROFILE="your-profile"
ARTIFACT_DIR="/path/to/artifact-directory"
dsh plugin --profile "$PROFILE" add "$ARTIFACT_DIR/thaliris-dsh-plugin-0.2.0.tgz" "$ARTIFACT_DIR/thaliris-dsh-memory-0.1.0.tgz" "$ARTIFACT_DIR/thaliris-dsh-memory-local-0.1.0.tgz"
生成的 bundle 默认禁用 runtime/API。启用前在插件配置中设置绝对路径的 pythonExecutable、corePath 和 authorityDirectory：corePath 须指向与上述 Python 环境相同的 Core 安装；authorityDirectory 应放在受治理 Workspace 之外。不要在插件配置里保存凭据。
package.json 中 peer 依赖包括 @deepseek-ai/cordis 4.0.4、@deepseek-ai/dsh-agent 等 0.2.0-rc.2 系列包，实际安装须与 CORE-BASELINE.md 所 pin 的 DSH 检出一致。
典型用法（流程层面）¶
1、在仓库内用 thaliris-core 完成 init，必要时 task-start 取得 task_id。
2、在 DSH 中注册该仓库为 native Workspace，建立或恢复与任务绑定的持久 root Session。
3、在 Thaliris 策略页为 Controller 与各角色配置提示词、模型路由（inherit / fixed / allowed）和工具；绑定正确的 Workspace ID 与 root。
4、由 Controller 按任务需要委派 Investigator / Implementer / Reviewer 等；子代理在隔离上下文中工作，结果与未处置 observation 经 Adapter 回传 Controller。
5、Controller 对需求与反证做显式 judgment，再决定是否继续实现、修复或关闭任务；可选 Memory 仅在明确启用并按文档授权时使用。
更细的路由、交接与验收规则见 Thaliris 主仓库的 路由协议 与 Thaliris-dsh 的 PROMPT-CONTRACT.md。
适用场景与注意¶
适合谁： 已在 DSH 上使用原生 Agent/subagent，希望在长程任务里做角色隔离、独立审查，并让反证在交接中保持可见直到被 Controller 处置的团队；愿意同时维护 Thaliris Core 与 pin 过的 DSH 构建配对。
状态与预期： 官方 README 标明 Beta，并在复杂重构基准（ABCD）中记录了多代理与单代理对照样本；样本量小，尚不能证明普遍的质量或成本优势，Evidence Continuity 的持久化链路仍在完善。阅读结果时应关注原始需求是否持续约束方案与反证是否推动修复，而非仅看局部测试是否通过。
安全与权限： 插件在当前 DSH 进程权限下运行，会通过配置的 Python 与 Core 读写你指定的仓库与 authorityDirectory。安装前应阅读源码、LICENSE（MIT）及 CAPABILITIES.md，确认路径与 Workspace 治理策略符合你的环境；勿在配置中存放密钥。
结尾¶
Thaliris-dsh 把 Thaliris 的认知隔离与证据连续性接到 DSH 原生能力之上：强模型留在关键判断节点，噪声在子上下文里处理，局部「完成」不会自动抹掉未处置的反证。若你要在 Harness 里试工作流类编排而非单纯加长上下文，可从 Core 初始化与插件 archive 安装做起，并对照 Core baseline 与能力文档完成启用。
