hrygo/heluo-forge--packages-forge-gitee ↗★ 7

@heluo/forge-gitee

Gitee change-flow host plugin for Heluo Forge: gitee.* read queries, policy-gated controlled writes, review/delivery judgement, local git commit/push behind the same policy gate, and the enterprise Gitee settings section

Package
@heluo/forge-gitee
Compatibility
Unverified
Harness peer range
>=0.2.1-rc.2
Version
0.1.0
Last updated
Nov 13, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add 'github:hrygo/heluo-forge#a2786f5e1152fb52c08cebeccaad7dd13dcbcb09&path:packages/forge-gitee'

配置

五个扁平键,全部可选,来自补丁层的 config:(r15 起也可在设置页改其中两项,见设置页)。配置里没有存令牌的字段——凭据主路径是 gh 自己的系统凭据库(服务名 gitee-cli-go),先在终端运行一次 gh auth login;authEnv 只是无桌面凭据库或 CI 的兜底注入通道。空配置也是合法状态。

键默认约束说明
cliPathgh可执行文件名/路径;拒绝 scheme://、控制字符、.cmd/.bat/.ps1/.com/.vbs 包装脚本企业已确认 CLI 名为 gh;配置值只决定"起哪个程序",不改变命令面
host空(无默认)主机名(可带端口),拒绝协议前缀、路径与 userinfor10 起不必填:不配即不做企业域断言;配了非企业主机仍以 HOST_NOT_ENTERPRISE 拒绝。只用于诊断与企业域校验:它不是 CLI 参数也不是环境变量,CLI 的主机来自它自己的 ~/.gitee-cli/config.json 的 base_url(规格 §1.1/§1.5)
timeoutMs200001000–600000 的整数单次 CLI 调用超时;超时按"可能已执行"降级 unknown,不重放
authEnv[]最多 8 个变量名([A-Za-z_][A-Za-z0-9_]*)兜底凭据变量名清单。不点名时 preflight() 返回 tokenSource: 'none',这不代表未认证:gh 仍会查系统凭据库;GITEE_TOKEN 是子进程白名单里的唯一凭据例外、不点名也会继承,其它凭据变量仍只经这里显式注入。服务端 401/403 时如实降级 AUTH_MISSING(有子进程),不阻断装配
persistentToken'warn''warn' | 'block'CLI 配置目录含持久令牌时的策略:候选含 ~/.gitee-cli/config.json(JSON 里 token 非空即命中)与 gh 兼容的 hosts.yml 等;warn 只提示,block 才拒绝执行(合规场景保留)

describeGiteeConfig() 只输出枚举、数字与环境变量名(路径只留文件名),返回值里不存在令牌值;validateGiteeConfig() 是补丁层、宿主 ConfigStandard 与 resolve 的唯一口径,未知键直接拒绝,missing 只收"提供了但非法"的键。