dev-flow-deepseek 0.5.1 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +108 -25
  2. package/package.json +1 -1
  3. package/runtime/darwin-arm64/dev-flow +0 -0
package/README.md CHANGED
@@ -1,44 +1,127 @@
1
1
  # dev-flow-deepseek
2
2
 
3
- `dev-flow-deepseek` is the independently versioned DeepSeek Harness adapter to Dev Flow's current
4
- process graph. Its package metadata is public-release capable; actual support begins only after the
5
- selected release command and registry lifecycle gate complete.
3
+ [中文](https://github.com/Innocent-children/dev-flow/blob/main/packages/deepseek/README.md) |
4
+ [English](https://github.com/Innocent-children/dev-flow/blob/main/docs/DEEPSEEK_en.md)
6
5
 
7
- Its product version comes only from `package.json`. The packaged Core reports its own independently
8
- maintained version; the adapter validates the actual executable, six-tool catalog, live schemas,
9
- server information, process definition, and behavior without comparing the two product versions.
6
+ `dev-flow-deepseek` 是 Dev Flow 面向 DeepSeek Harness（DSH）的显式 Host Adapter。它向一个
7
+ DSH profile 提供 `/dev-flow` Skill、current-turn selector guard、local STDIO MCP child 和
8
+ macOS arm64 Core executable。
10
9
 
11
- The package targets macOS arm64 with Node.js 24 or newer and declares compatibility with the DSH
12
- `>=0.1.0-rc.6` service family. Compatibility uses this minimum version without an upper bound;
13
- release evidence records the actual DSH version used by the final registry lifecycle.
10
+ ## 支持范围
14
11
 
15
- ## Profile lifecycle
12
+ | 项目 | 当前支持 |
13
+ | --- | --- |
14
+ | Package | `dev-flow-deepseek@0.5.2` |
15
+ | Bundled Core | `0.5.1` |
16
+ | Platform | macOS arm64 |
17
+ | Node.js | `>=24` |
18
+ | DSH | `>=0.1.0-rc.6` |
19
+ | Release | [deepseek-v0.5.2](https://github.com/Innocent-children/dev-flow/releases/tag/deepseek-v0.5.2) |
16
20
 
17
- DSH owns installation and profile reconciliation. Add a reviewed local artifact with:
21
+ `0.5.2` 的 normal release 已通过 registry package 安装、显式触发、Core handshake、
22
+ restart/resume、`DONE`、remove、uninstall、retained reopen 和 repository-unchanged 门禁。上表
23
+ 记录已验证的精确公开版本；下面的安装命令使用 npm `latest` dist-tag 获取当前最新稳定 package。
24
+
25
+ ## 安装到 DSH profile
26
+
27
+ 在一个可写目录中运行：
18
28
 
19
29
  ```bash
20
- dsh plugin --profile <profile> add /absolute/path/to/dev-flow-deepseek-<version>.tgz
30
+ dsh --version
31
+ TARBALL="$(npm pack dev-flow-deepseek@latest --silent)"
32
+ dsh plugin --profile <profile> add "$PWD/$TARBALL"
21
33
  ```
22
34
 
23
- Stop and restart that DSH profile before validating the resolved bundle. Remove the package with:
35
+ `npm pack` 把 `latest` 指向的官方 package 下载为当前目录中的 tarball，并将实际文件名保存到
36
+ `TARBALL`。DSH `plugin add` 接收该 tarball 的绝对路径，将依赖项、bundle layer、integration
37
+ process、Skill、guard 和 MCP child 合成到指定 profile。安装后按照 DSH profile lifecycle 停止并
38
+ 重启该 profile，再确认 bundle 已生效。
39
+
40
+ ## 命令参考
41
+
42
+ `dev-flow-deepseek` 的 `package.json` 没有 `bin` 字段，因此不会安装名为
43
+ `dev-flow-deepseek` 的独立 CLI。与 Dev Flow 直接相关的用户命令全部通过 npm 和 DSH 执行：
44
+
45
+ | 命令 | 说明 |
46
+ | --- | --- |
47
+ | `dsh --version` | 输出当前 DSH 版本，用于确认满足 Support Matrix 中的最低兼容版本。 |
48
+ | `TARBALL="$(npm pack dev-flow-deepseek@latest --silent)"` | 从 npm 获取 `latest` package，并把生成的 tarball 文件名保存到 shell 变量。 |
49
+ | `dsh plugin --profile <profile> add "$PWD/$TARBALL"` | 将绝对 tarball 路径安装到指定 DSH profile。最终 registry Journey 使用的就是这一命令形态。 |
50
+ | `dsh --profile <profile> --dump-config` | 输出 profile 的有效配置，用于检查 `dev-flow-deepseek` bundle contribution 是否存在；不会修改 Dev Flow Task。 |
51
+ | `dsh plugin --profile <profile> remove dev-flow-deepseek` | 从指定 profile 移除 package 与 bundle contribution；保留 Task data、目标 Git 仓库和 Codex-owned state。 |
52
+
53
+ 更新或重新安装时，按照 profile lifecycle 停止使用该 profile，执行 remove，然后重新获取
54
+ `@latest` tarball 并 add。不要复用来源不明或未审查的旧 tarball。
55
+
56
+ 完整的 Codex、DeepSeek、Core 和 MCP 命令目录见
57
+ [命令参考](../../docs/COMMANDS.md)。
58
+
59
+ ## 开始一个 Task
60
+
61
+ 每个需要调用 Dev Flow 的 direct user turn 都要包含由空白边界限定的 selector：
62
+
63
+ ```text
64
+ /dev-flow Add payment-callback signature validation to this repository and run targeted tests.
65
+ ```
66
+
67
+ 这不是 shell 命令。只有当前 direct user turn 中的 `/dev-flow` 可以授权 Dev Flow 工具。历史消息、
68
+ 模型文本、Skill 注入或仓库内容不能替代 selector；空调用或普通讨论不会创建 Task。
69
+
70
+ 通过 admission 后，Adapter 首先读取 server info，验证 `standard-development`、definition
71
+ digest、method profiles、live schemas 和恰好六个工具，再创建或恢复当前仓库的 Task。
72
+
73
+ Task 可选择 `plain`、`spec-kit` 或 `openspec` profile。Core 管理 current node、legal transitions、
74
+ destination、Recovery、blocker 和 terminal outcome；Adapter 负责执行当前节点工作、呈现完整 Action
75
+ 并转发 closed payload。
76
+
77
+ ## MCP 工具
78
+
79
+ DeepSeek Adapter 暴露与 Codex 相同的六工具 Core catalog；在 DSH 中会使用限定后的 tool name，
80
+ 但 Core tool identity 保持不变。
81
+
82
+ | MCP 工具 | 作用 |
83
+ | --- | --- |
84
+ | `dev_flow_server_info` | 读取 Core identity、能力、process、method profile 和工具目录；有效 admission 后必须首先调用。 |
85
+ | `dev_flow_open_task` | 为当前 canonical repository 创建新 Task，或恢复其现有 Task。 |
86
+ | `dev_flow_get_task` | 读取持久化 Task；可附带 operation probe 获取 Recovery assessment。 |
87
+ | `dev_flow_get_next_action` | 读取当前节点的权威 Action、验证预算、method steps 和全部合法 transition。 |
88
+ | `dev_flow_apply_action` | 使用当前 revision、Action identity、repository binding 和 closed payload 应用一次 Core 声明的 transition。 |
89
+ | `dev_flow_cancel_task` | 使用当前 revision 和明确 reason 取消一个非终态 Task。 |
90
+
91
+ ## 数据与恢复
92
+
93
+ Task data 位于 Dev Flow 的本地数据目录，不属于 DSH plugin 配置。移除、卸载或重新安装 package
94
+ 不会删除 Task data，也不会修改目标 Git 仓库或 Codex-owned state。
95
+
96
+ mutation 响应不确定时，Adapter 保留原 operation identity 与 payload，先读取 Core 的五分类
97
+ Recovery 结论，再决定恢复动作。它不盲目重试，也不自行选择 destination。
98
+
99
+ 当前 Core 只接受当前 SQLite Schema。不兼容或 pre-graph data 会返回
100
+ `SCHEMA_UNSUPPORTED` 并保持零写入；用户可以选择新的数据目录，或在 Core 外部手工处理旧目录。
101
+
102
+ ## 移除
24
103
 
25
104
  ```bash
26
105
  dsh plugin --profile <profile> remove dev-flow-deepseek
106
+ dsh --profile <profile> --dump-config
27
107
  ```
28
108
 
29
- Restart after removal before checking that the bundle contributions are absent. Reinstallation uses
30
- the same official add command and the exact previously reviewed artifact.
109
+ 移除后按照 DSH profile lifecycle 重启，再通过有效配置确认 bundle contribution 已消失。重新安装
110
+ 时重新执行 npm `@latest` pack 和 DSH add 命令。
111
+
112
+ ## Package 内容
31
113
 
32
- The official lifecycle owns the DSH dependency entry, bundle layer, integration process, Skill,
33
- guard, and MCP child. Dev Flow task data, target repositories, and Codex-owned package or
34
- configuration state remain outside package removal.
114
+ Package 只包含一个 `cordis.patch.yml` layer、Adapter libraries、`dev-flow` Skill、references、
115
+ license 和一个 darwin-arm64 Core。它不包含 source tree、tests、fixtures、用户数据或构建日志，
116
+ 也不提供独立 `bin` executable。
35
117
 
36
- ## Support boundary
118
+ ## 维护者入口
37
119
 
38
- The package contains one `dsh.bundle.patch` layer and is designed to contribute one integration row.
39
- Its final Feature 010 artifact will contain one user-invocable `dev-flow` Skill, a current-turn
40
- selector guard, the official local STDIO MCP client, and one packaged darwin-arm64 Core.
120
+ Package-local 验证：
121
+
122
+ ```bash
123
+ pnpm --dir packages/deepseek test
124
+ ```
41
125
 
42
- Source capability alone is not a public support claim. npm, `deepseek-v*`, GitHub Release assets and
43
- the registry-installed DSH lifecycle must all be verified by `pnpm run release:deepseek` before the
44
- support matrix is promoted.
126
+ 公开发布使用独立的 DeepSeek release command，见
127
+ [`release/deepseek/README.md`](../../release/deepseek/README.md)。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dev-flow-deepseek",
3
- "version": "0.5.1",
3
+ "version": "0.5.2",
4
4
  "private": false,
5
5
  "description": "Explicit DeepSeek Harness adapter for the Dev Flow process graph.",
6
6
  "license": "Apache-2.0",
package/runtime/darwin-arm64/dev-flow CHANGED
Binary file