前言¶
在 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 與能力文檔完成啓用。
