@suifei/dsh-ai-team 0.0.0-stage → 0.3.4

package/CHANGELOG.md

@@ -0,0 +1,104 @@
+# Changelog
+
+## 0.3.4 — 2026-11-09
+
+- README 精装修：品牌、快速开始、能力地图、架构图、API、验证证据、文档索引；
+- 发布到 npm / GitHub Releases，补充 repository / homepage / keywords / LICENSE；
+- desktop profile 改为从 npm 安装。
+
+## 0.3.3 — 2026-11-09
+
+- 产品显示名改为「文渊阁」（Wenyuan Pavilion），取藏修、校勘、纂辑之意；
+- 保持包名 `@suifei/dsh-ai-team` 与内部 Team 域对象不变。
+
+## 0.3.2 — 2026-11-09
+
+- 产品显示名改为「三省」（Three Departments），副标「三省六部」；
+- 修复热加载时 permission 服务尚未就绪导致 `BOOT_FAILED / permission services are unavailable`，Host 显式 inject `permissionPresets` 与 `sandboxPolicy`；
+- 四象限空 items / null taskNumber / 无 taskId 的决策项做健壮处理，避免点击异常与 `#null` 文案。
+
+## 0.3.1 — 2026-11-09
+
+- SkillOpt 完全内置：7 个 `skillopt_*` 工具、Python engine bootstrap、`skillopt-sleep` 技能随插件分发，不再装到用户 DSH；
+- 冷恢复重新 mount member preset，修复重启后 `pwsh/read/write` 工具消失；
+- 失败决策自动带 taskId；跨 Project 收件箱可一键打开 Task；
+- 双真实 provider SSE：DeepSeek 与 Zhipu 各自项目独立分桶；
+- 测试 82 条。
+
+## 0.3.0 — 2026-11-09
+
+- 并发 ProjectRuntime：启动打开全部 Project，各自 ledger/Waker/SSE/Team 工具路由；
+- 跨 Project 收件箱：聚合、项目标记、按项目 ack、打开 Task 前切项目；
+- V-10：新增真实 turn 中途降级 E2E 测试钩子（生产 403），守卫在工具调用前修复权限；
+- billing/网络：测试专用 `ai-team-fault` LLM adapter，真实 Agent loop 验证 402 与 ECONNRESET 分类/恢复；
+- 技能：新增 `ai-team-files` provider，发现 `~/.dsh/skills` 与项目技能；nuwa/distilly/darwin/SkillOpt 四个技能安装并由真实成员加载。
+
+## 0.2.6 — 2026-11-09
+
+- 工具调用前权限守卫：managed member 若在 turn 中途被降级，下一步工具前先修复为 danger-full-access；修不好则拒绝；
+- 非成员工具调用不受影响；
+- V-10 从“仅激活时检查”前移到每次工具调用。
+
+## 0.2.5 — 2026-11-09
+
+- 成员 config 新增 `preset`：`standard / ptc / minimal / cordis`，默认 `standard`；
+- 资料抽屉可选择运行配方；
+- 激活时 mount 对应 preset，未知配方被校验拒绝。
+
+## 0.2.4 — 2026-11-09
+
+- 修复成员工具链：`agents.create` 的 setup 里 mount `standard` preset，成员获得 pwsh/read/write/edit/skill 等完整工具；
+- 真实成员用 pwsh 写文件、用 skill 加载 DSH 技能并写结果；
+- 健康检查暴露 `presets` 与 `skillsService`。
+
+## 0.2.3 — 2026-11-09
+
+- 成员 activation/wake 注入 DSH `skills` 目录摘要（名称/描述/何时用，最多 12 条）；
+- 完整技能正文由成员自己的 `skill` 工具按需加载；
+- 保留 `<dataDir>/skills/<name>/SKILL.md` 有界注入。
+
+## 0.2.2 — 2026-11-09
+
+- 多 Project 单活动切换：每 Project 独立 ledger，`projects.json` 索引；
+- Host `project.create` / `project.activate`；
+- UI 新建项目弹窗 + 项目列表切换；
+- 切换后重拉 bootstrap、重连 SSE，未完成 Task 由 `team/startup` 恢复；
+- 已知限制：同一时刻只开一个 Project runtime，非活动项目不并发唤醒。
+
+## 0.2.1 — 2026-11-09
+
+- QA checklist 硬门禁：`qaRequired` + `qaChecklist`，全部通过才能 accept。
+- 启动恢复：`team/startup` 恢复未完成 Task，无定时器；真实重启 E2E 跑通。
+- 抽出 `ProjectRuntime`（默认项目行为不变），为多 Project 做准备。
+- 修复资料抽屉白屏（early-return 前引用 selectedTask / data null）。
+- 真实浏览器验证 DM：`member.message` + wake，成员 session 前进。
+
+## 0.2.0 — 2026-11-09
+
+M2.5「团队进化」迭代。
+
+### 新增
+
+- 成员资料：name / role / personality / profileVersion；Human 可编辑，空个性按“不修改”处理。
+- 自我进化：`team.evolve` 只允许 Agent 改自己的 personality；验收后 reflection wake 触发；真实跑通并写 `member/distilled`。
+- 模型蒸馏：`member.distill(mode:'model')` 由 Host 单步调用 `llm.stream`，无工具、固定 JSON schema；真实跑通。
+- 人才库：`member.leave` / `member.rejoin`，身份与 session 保留；`member.takeover` 接遗留 Task，保留 claim/takeover 历史。
+- QA：`qaRequired` 硬门禁、`qaChecklist` 逐项通过、QA 优先自动 reviewer；真实 QA 自动验收。
+- 备忘/技能：`team.note` / `team.skill` / `team.recall`；`<dataDir>/skills/<name>/SKILL.md` 有界加载进 prompt。
+- 私信：`member.message` 只唤醒目标成员。
+- 关注：`task.follow`；验收后给仍关注者生成 `followed_task_update`。
+- 收件箱：真实 `data.inbox`、ack、打开 Task；失败恢复 UI（改配置 + retry）。
+- 启动恢复：`team/startup` 恢复未完成 Task，无定时器；真实重启 E2E。
+- 任务动作 UI：取消/重开/删除/改派；Thread 回复/验收/退回真实命令。
+- 安装/卸载/升级文档与 profile 隔离检查。
+
+### 测试
+
+- `node --test` 71/71。
+
+### 已知边界
+
+- 单机、单 Human；多 Project 仍以默认 Project 为主。
+- 技能文件只进 prompt，不是可执行工具注册。
+- 外部失败注入仅覆盖真实 401；billing/网络注入仍待。
+- 多 Project、V-10、真实卸载/升级演练未完成。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 suifei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,227 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="./icon.svg" width="88" height="88" alt="文渊阁" />
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<h1 align="center">文渊阁</h1>
+
+<p align="center">
+  <strong>把工作交给一支 AI 团队：它们把事做到底，你定方向、把关键的关。</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@suifei/dsh-ai-team"><img alt="npm" src="https://img.shields.io/npm/v/@suifei/dsh-ai-team?color=2f6feb&label=npm"></a>
+  <a href="https://github.com/suifei/dsh-ai-team/releases"><img alt="release" src="https://img.shields.io/github/v/release/suifei/dsh-ai-team?color=2f6feb"></a>
+  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-2f6feb"></a>
+  <img alt="tests" src="https://img.shields.io/badge/tests-82%20passing-2ea043">
+  <img alt="dsh" src="https://img.shields.io/badge/DeepSeek%20Harness-plugin-6f42c1">
+</p>
+
+> 文渊阁，藏修、校勘、纂辑之地。  
+> 在这里，Human 不在环里逐条调度，而是在环上定方向、守信任、做最后那一步。
+
+`@suifei/dsh-ai-team` 是 DeepSeek Harness 的按需启用插件：装进专用 `ai-team` profile 后，DSH 里出现一个三栏工作台——左侧 Project 与成员，中间主对话 / 看板 / 态势，右侧 Thread。Agent 自己认领 Task、互相交接，由做的人以外的成员验收；Human 只处理方向、信任和不可撤回的决定。
+
+---
+
+## 为什么是「文渊阁」
+
+- **成员是持久的。** 每个 Agent 有名字、角色、personality、notes、skills 和 session；DSH 重启、上下文压缩、换代之后，它还是它。
+- **每个结果都有 owner。** Project 有具名 owner；Task 有唯一 accountable owner，由它推到验收。
+- **做的人不验收。** Agent 只能验收已进入待验收、且自己从未认领过的 Task；QA Task 只有 QA 成员能验收。
+- **房间是为 Agent 设计的。** 成员从自己的 inbox 拉取消息，而不是被每条消息推着走；对着已经变化的 Thread 写的回复会被退回，并附上变化摘要。
+- **一切有记录。** Main stream、Thread、Task、收件箱都是同一本 append-only 账本的视图。
+- **没有定时器。** Agent 只由 Team 事件（消息、@、交接、验收请求）唤醒；团队完全安静时不会自己醒来。
+
+---
+
+## 快速开始
+
+### 1. 建专用 profile
+
+```powershell
+dsh --profile ai-team --from-default-profile web --dump-config
+```
+
+### 2. 从 npm 安装
+
+```powershell
+dsh plugin --profile ai-team add @suifei/dsh-ai-team
+```
+
+或从 checkout 安装：
+
+```powershell
+dsh plugin --profile ai-team add E:/works/dsh-ai-team
+```
+
+### 3. 启动
+
+```powershell
+dsh --profile ai-team --no-open --port 33271
+```
+
+打开终端输出的 URL，点侧栏 **文渊阁**。
+
+> 插件只应安装在可信机器 / 可信 Workspace：成员以 `danger-full-access` 运行，且 profile patch 会把 sandbox / approval / permission 固定为 `danger-full-access / never`。普通 `desktop`/`web` profile 不安装时保持原有 preset roster。
+
+---
+
+## 界面
+
+```text
+┌ 文渊阁 ───────────────────────────────────────────────────────────┐
+│ Projects        │  Main stream / Board / Situation   │  Thread     │
+│  # 我的项目      │  主对话：一句话开工                 │  回复        │
+│  # UI 项目       │  看板：待处理 / 进行中 / 待验收 / 完成│  验收 / 退回  │
+│                 │  态势：需要你 / 团队在做 / 等待受阻 / 最近完成 │ 任务动作     │
+│ Agents          │                                    │             │
+│  沈舟 (Lead)     │                                    │             │
+│  林岚 (QA)       │                                    │             │
+└─────────────────┴────────────────────────────────────┴─────────────┘
+```
+
+- **主对话**：Human 的一句话进入 Main stream，Project owner 拆 Task；Composer 支持讨论 / 任务模式。
+- **看板**：四列；进行中的卡片显示 accountable owner 与执行者；数量只统计 active Task。
+- **态势**：四象限——需要你、团队在做、等待受阻、最近完成。点击条目打开对应 Task 的 Thread。
+- **收件箱**：跨 Project 聚合；失败决策、需要你决定、关注 Task 的完成报告都在这里。
+- **成员资料**：改名、职责、personality、provider/model、运行配方、notes、skills、re-distill、离队/人才库。
+
+---
+
+## 能力地图
+
+| 能力 | 说明 |
+|---|---|
+| Project | 具名 owner；并发 runtime；每 Project 独立账本、Waker、SSE |
+| Task | 唯一 accountable owner；pending / in_progress / pending_acceptance / done / cancelled |
+| Thread | append-only；回复带 `baseSeq`，旧基线会被拒并说明变化 |
+| 验收 | maker 不能验收；QA 硬门禁；`qaChecklist` 逐项通过 |
+| 收件箱 | Human/Agent 各自拉取；跨 Project 聚合与项目内 ack |
+| 关注 | 关注 Task；完成后收到 `followed_task_update` |
+| 成员 | 持久 session；名字/角色/personality/notes/skills |
+| 进化 | `team.evolve` 只改自己的 personality；验收后 reflection wake |
+| 人才库 | leave/rejoin；遗留 Task 可被接管（taken-over） |
+| 运行配方 | `standard` / `ptc` / `minimal` / `cordis` |
+| 技能 | DSH `skill` 工具真实加载；SkillOpt 7 工具内置 |
+| 重启恢复 | `team/startup` 恢复未完成 Task，无定时器 |
+| 安全 | 每次成员工具调用前守卫 `danger-full-access` |
+
+---
+
+## 架构
+
+```mermaid
+flowchart TB
+  H[Human] --> UI[文渊阁 Workbench]
+  UI --> HOST[Host /ai-team/api]
+  HOST --> R1[ProjectRuntime prj_main]
+  HOST --> R2[ProjectRuntime prj_ui]
+  R1 --> L1[(append-only ledger)]
+  R2 --> L2[(append-only ledger)]
+  R1 --> S1[TeamService]
+  R2 --> S2[TeamService]
+  S1 --> M1[Member sessions]
+  S2 --> M2[Member sessions]
+  L1 -. Waker / SSE .-> M1
+  L2 -. Waker / SSE .-> M2
+```
+
+- **Host**：路由、命令、SSE、Waker、成员 runtime、权限守卫。
+- **ProjectRuntime**：一个 Project 一个 ledger + TeamService；启动时全部打开。
+- **Ledger**：JSONL + SHA-256 hash chain + checkpoint + 纯函数 fold。
+- **MemberRuntime**：真实 DSH Agent session，直接 `agents.create` / `followup`，没有模拟执行。
+- **Waker**：只从账本 append / HTTP 命令结果计划唤醒；没有 heartbeat/timer。
+
+### API 速览
+
+```text
+GET  /ai-team/api/health
+GET  /ai-team/api/bootstrap?project=<id>
+GET  /ai-team/api/projects/<id>/board
+GET  /ai-team/api/projects/<id>/quadrants
+GET  /ai-team/api/projects/<id>/events      # SSE
+POST /ai-team/api/projects/<id>/commands
+```
+
+命令覆盖 `task.create/claim/submit/accept/request_changes/cancel/reopen/delete/reassign`、`member.add/activate/config.update/profile.update/message/leave/rejoin/takeover`、`project.create/activate`、`inbox.ack` 等。
+
+---
+
+## 技能与 SkillOpt
+
+- 成员资料可追加 notes / skills，activation / wake prompt 会注入有界技能目录；
+- 完整技能正文由成员自己的 `skill` 工具加载；
+- `ai-team-files` provider 会读取：
+  - `<DSH_HOME>/skills`
+  - `<cwd>/.dsh/skills`
+  - `<cwd>/.agents/skills`
+- **Microsoft SkillOpt 已内置**：7 个 `skillopt_*` 工具、Python engine bootstrap、`skillopt-sleep` 技能随插件分发，不需要单独安装 `dsh-skillopt`。
+
+---
+
+## 验证
+
+- `node --test`：**82 / 82**
+- 文档 QA：`node .ptc/tools/docs_check.mjs` → **0 problems**
+- 真实 E2E 覆盖：
+  - 两 Agent claim → Thread → 独立验收；
+  - 一句话 → Lead 开卡 → QA 自动验收 → owner 自进化；
+  - 强停重启 → `startup_resume` → 继续 Task；
+  - 真实浏览器私信成员；
+  - 四运行配方分别执行 `run_code` / `pwsh`；
+  - 并发 Project + 跨 Project 收件箱；
+  - DeepSeek + Zhipu 双订阅 SSE 分桶；
+  - V-10 turn 中途权限降级后工具前修复；
+  - billing 402 / ECONNRESET 三次重试与恢复；
+  - 从 npm 安装后在独立 profile 启动 health 200。
+
+证据目录（本机 `.ptc/rounds/`，不随 npm 发布）：
+
+```text
+round-02  两 Agent 独立验收
+round-06  验收后 self-evolve
+round-09  重启 startup_resume
+round-10  资料抽屉私信
+round-11  多 Project 新建/切换
+round-12  成员工具链 + skill 加载
+round-13  四种运行配方
+round-14  安装/卸载 smoke
+round-15  并发/收件箱/V-10/billing
+round-16  四技能安装
+round-17  SkillOpt 内置 + 冷恢复
+round-18  跨 Project 打开 Task + SSE 分桶
+round-19  DeepSeek + Zhipu 双 provider
+```
+
+---
+
+## 文档
+
+- [需求研究](docs/01-需求研究报告.md)
+- [PRD](docs/02-产品需求文档-PRD.md)
+- [架构设计](docs/03-架构设计报告.md)
+- [UI/UX/UE 研究](docs/04-UI-UX-UE研究报告.md)
+- [启动与执行计划](docs/05-项目启动与执行计划.md)
+- [会议纪要](docs/06-会议纪要.md)
+- [四象限设计](docs/07-四象限视图研究与设计.md)
+- [异常恢复与模型治理](docs/08-异常恢复与模型治理.md)
+- [团队进化与人才库](docs/09-团队进化与人才库.md)
+- [安装、卸载与升级](docs/10-安装卸载升级.md)
+- [M3 并发多项目与边界补齐](docs/reports/M3-并发多项目与边界补齐.md)
+
+---
+
+## 当前边界
+
+- 单机、单 Human；不支持多 Human 共享 Team；
+- billing/网络注入是测试 adapter，不是物理断网；
+- SSE 分桶用两个真实 provider 的独立订阅端验证，不是两个浏览器窗口；
+- nuwa / distilly / darwin 不内置，有则用、无则不用；
+- desktop profile 由插件 patch 固定为 `danger-full-access / never`，只应在可信机器使用。
+
+---
+
+## License
+
+MIT。  
+Bundled SkillOpt integration derives from [Microsoft SkillOpt](https://github.com/microsoft/SkillOpt) `plugins/dsh` (MIT); its license lives at `lib/vendor/skillopt/LICENSE`.